home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
PC Media 4
/
PC MEDIA CD04.iso
/
share
/
udos
/
tw3
/
tw.doc
< prev
next >
Wrap
Text File
|
1992-10-12
|
94KB
|
2,419 lines
TreeWalk (TW.EXE) - V3.00 - User Documentation
=====================================================================
User Documentation for
TreeWalker V3.00
(TW.EXE)
A Utility Program By
Steve Dunn
50 Hillside Drive
Hanover, MA. 02339
CompuServe ID: 70034,2454
=====================================================================
Page: 1 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
╔═══════════════════╗
║ T A B L E ║
║ O F ║
║ C O N T E N T S ║
╚═══════════════════╝
Section: Page:
Introduction ............................................ 3
Distribution ............................................ 4
Getting Started ......................................... 5
Using TREEWALK.INI to change defaults ................... 9
The Initial Screen ...................................... 10
Using the TREE Manager .................................. 13
HELP ................................................ 13
MKDIR (make a new directory)......................... 13
DRIVE (choose a new drive)........................... 14
RMDIR (delete a directory and all its files)......... 14
PATHS (display as path NAMES or as TREE)............. 15
SEARCH (for file, global) ........................... 15
DELETE (file(s) - global) ........................... 15
PRINT (path NAMES or TREE) .......................... 16
STATS (on current drive) ............................ 16
LOAD (invoke FILE MANAGER) ......................... 17
Using the FILE Manager .................................. 18
General Introduction ................................ 18
HELP ................................................ 21
COPY (one or more files) ............................ 21
MOVE (one or more files) ............................ 21
VIEW/EDIT (work with file) .......................... 22
MARK (one or more files) ............................ 23
MASK (limit display of files) ....................... 24
DELETE (one or more files) .......................... 25
PRINT (listing of files displayed) .................. 25
CHANGE (file name or attributes) .................... 25
SORT (files being displayed) ........................ 26
SHELL (invoke DOS SHELL) ............................ 26
4DOS / NDOS Features ................................ 27
Program Limitations ..................................... 28
Tech Note ............................................... 29
Revision History ........................................ 30
Appendix A - Quick Reference to TW Parameters .......... 32
Appendix B - Map of Color Values in TREEWALK.INI ....... 33
Appendix C - Using Printer Control Codes in TREEWALK.INI 37
Page: 2 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
Introduction:
------------
TW.EXE is intended as a full-featured and easy-to-use DOS
File Manager and Disk(ette) Manager. It features a "point-and-shoot"
environment and simplified menus of various functions. On-line help
is available at various points during program execution by pressing
"F1".
You should received the following files for this version:
TW.EXE - the main executable program file
TW.DOC - the ASCII text user documentation (this
file!). If you wish, you can print this
file via the DOS command COPY TW.DOC PRN.
TREEWALK.INI - a sample configuration file for TW.EXE
README.1ST - some rudimentary notes in ASCII format
TW_INI.* - alternate color schemes - just rename one
of these to TREEWALK.INI to try them out.
In general, all program functions are activated either by
pressing one of the FKeys or, where there are subsequent menus, by
pressing the letter or character key contained in the square brackets.
TW.EXE was originally intended to help new DOS users learn
how their disk(ette)s are organized, how to use the "TREE" structure,
etc. and to simplify various DOS-level file management capabilites.
TW.EXE V3.00 requires a CGA/EGA/VGA etc (i.e., no monochrome
adapter cards), and DOS V2.00 or higher, but is otherwise designed to
work on any MS-DOS / PC-DOS PC system - it uses no undocumented DOS
or BIOS calls. It may, however, cause screen "snow" on older PC CGA
displays (sorry about that!). It requires a minimum of 320K free
RAM, and will handle 300 sub-directories per drive, and 700 files per
sub-directory.
TW.EXE will run under both plain old DOS, or either 4DOS
(from J.P.Software) or NDOS (licensed from J.P.Software by Symantech
as part of the "Norton Utilities"). If you do run 4DOS or NDOS,
additional TW features will be available, specifically supporting the
"file commenting" features available under either of these two fine
products. TW V3.00 may be run under Microsoft Windows (V3.00
or V3.1) either as a full screen or as a windowed application.
I hope you enjoy using it as much as I enjoyed writing it. I
would sincerely appreciate any and all feedback you may have
(comments, criticisms, suggestions for future versions, etc). Just
drop me a line on CompuServe electronic mail (see title page).
Page: 3 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
Distribution:
------------
Despite a strong temptation on my part, TreeWalk V3.00 is
*not* being distributed as "ShareWare". You may use TreeWalk V3.00
for any non-commercial purpose without paying any required fee.
At the same time, I'm sure you'll realize that TreeWalk
required a substantial amount of time and effort to design, develop,
debug, etc.; if you use TreeWalk on a regular and continuing basis,
please help me to continue to support and improve the product - "A
contribution in any amount (see address on page 1) would be greatly
appreciated".
V3.00 of TreeWalk may be copied and distributed freely,
subject to the following conditions:
<> You make *NO* changes to any of the files, and
<> You MUST distribute at least TW.EXE, TW.DOC, TREEWALK.INI,
README.1ST *together* and *unaltered*.
THIS PROGRAM IS BEING MADE AVAILABLE ON AN "AS IS" BASIS,
WITHOUT ANY GUARANTEE OR WARRANTY, EXPRESS OR IMPLIED,
INCLUDING FITNESS FOR ANY PARTICULAR PURPOSE.
YOU USE THIS SOFTWARE STRICTLY AT YOUR OWN RISK.
UNDER NO CIRCUMSTANCES WILL I BE LIABLE TO YOU FOR ANY
DAMAGES OF ANY SORT WHICH MAY RESULT
FROM YOUR USE OF THIS SOFTWARE.
In any event, I have beta-tested the initial releases of this
program both locally (on mainly IBM / Compaq hardware), among users
with varying degrees of PC experience (Thanks Kathie, Eleanor, Linda
and most especially, Neville!). This release has been largely shaped
by the combined feedback of the initial users, plus all the fine
folks in the electronic BBS world who have so graciously shared their
opinions with me (Thanks Dianne, Mark, Mike, Dennis, Jeff, Eugene, et
al!).
Technical support for TreeWalk is available via CompuServe
E-Mail [70034,2454], or regular mail / postcards; I'm sorry to say
that I do not have a phone line for TreeWalk users to call directly
(yet!).
Page: 4 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
Getting Started (see also Appendix A for Quick Reference):
---------------
TW.EXE is invoked from the DOS command line simply by typing
"TW" and pressing <enter> - note that all of the following command
line parms (except for drive spec and the "HELP" parm) can, as of
V2.01(and higher), also appear in a DOS ENVIRON variable in the
format:
set TREEWALK=/parm1 /parm2 ...
or, as they would appear on the DOS command line (and note that parms
on the DOS command line supercede parms set in the ENVIRON variable):
TW [d:|.] [/parm1] [/parm2] ... <enter>
d: - is optional, and represents the drive spec to start
with. If you omit this parm, the current default
DRIVE (and the current default PATH) will be used
automatically. In fact, the colon character is also
optional.
- The DRIVE or the "." must be the FIRST parm after
the TW (if you plan to use this optional parm at
all).
- Note that if you use a period character,
TW will start up and immediately enter the FILE
MANAGER for the current default drive and directory.
- If you DO specify a drive letter, TW will start
up in the ROOT directory of the given drive. TW will
still work if you specify a PATH, however, the
initial hilite bar will be on the ROOT directory of
whatever drive starts the PATH you specify instead of
whatever sub-directory you happen to be in when you
start the program.
- If you WANT to start in the ROOT, even of the
current default drive, use "d:\" (note the trailing
"\" character).
- NOTE: TW will check drives "A" and "B" to
be sure they are "ready" (i.e., they contain a
valid disk, the drive door is closed, ect) first; if
not, TW will warn you. TW assumes that any other
drive is *always* "ready", and does not specifically
check.
Page: 5 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
Getting Started (continued):
----------------------------
- However, TW WILL check to be sure that the drive
letter you give is, in fact, recognized as a drive on
your system. If not, TW will terminate and display
an error message which specifies which drives it can
accept.
- In general, this parm should be used only to start
by reading a drive other than the current default
drive. (You will be able to change drives later,
from within TW, if you wish).
/parm1,
/parm2 - are all optional, and may be any of the following,
in any order you want:
/25 - forces TW to start in 25 rows-per-screen mode.
This is the default mode.
/43 - forces TW to start in 43 rows-per-screen mode.
This works only if your system has an EGA adapter or
better.
/50 - forces TW to start in 50 rows-per-screen mode.
This works only if your system has a VGA adapter or
better.
NOTE: If you specify more than one of the above, TW uses
the highest row value it finds on the command line.
/R - forces TW to physically re-read the disk(ette) TREE
structure as it starts up. The default is to *NOT*
physically read the disk(ette) tree structure, but
rather to read the directory structure TW stored on
disk from the last time it was used.
- When TW is started for the first time, it will
automatically save two files to the ROOT directory of
the drive being read which will contain the DOS TREE
structure data (only for drive C: or higher - it will
not save tree structure files for drive A: or B:).
- Subsequently, when you start TW, it will read the
directory structure data contained in these two files
rather than go thru the time consuming physical disk
read.
Page: 6 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
Getting Started (continued):
----------------------------
- You may want to force this physical re-read if you
have created or deleted any directories under DOS, as
opposed to using TW for this purpose.
- This function can also be toggled "on" or "off"
from within TW, after you have started it (see also
"/NS", below).
- Incidentally, these two files are named "TW!.DAT"
and "TW!!.DAT", and are text files. You can view
them using TYPE or LIST, or even COPY them to the
printer if you wish.
- NOTE: if your printer does not support graphics
character printing, the results may be less than
satisfactory!). See "F8" in TREE MANAGER, below.
/NS - prevents TW from saving the "TW!.DAT" and
"TW!!.DAT" files (see above) to disk. This option is
included for completeness, but I don't use it myself.
- Note that TW must do a *physical* (i.e., time
consuming) disk read of the DOS TREE structure each
time it starts unless it can find the "TW!.DAT" and
"TW!!.DAT" files. These files are always located in
the root directory of the drive being accessed.
- Note that this feature can be toggled "on" and
"off" from within TW.EXE, but the default is that
TW.EXE *will* save these two files (see also "/R",
above).
/? - this parm causes TW to display on the screen info
/HELP on what all the available parms do - kind of
on-line help for the start up parms.
- NOTE: you cannot specify this parm in the DOS
ENVIRON "TREEWALK=" string.
/M - this parm causes TW.EXE to start up in monochrome
mode (the default is in color). This is useful if
you normally use a laptop or other monochrome system
(thanks, Mike!).
- NOTE: If you use "/M" in the "TREEWALK=" DOS
ENVIRON string, this "/M" parm CANNOT be superceded
by any command line parm.
Page: 7 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
- NOTE: If you use "/M" on the TW command line, any
color assignments you may have made in the
TREEWALK.INI file will be superceded.
/ASK - this parm causes TW.EXE to always ASK you what
program file to use for the file viewing / editing
function available from within the FILE MANAGER by
pressing either ENTER or F4.
- In addition to specifying a different program to
use for each file you hilite in the FILE MANAGER,
this option also allows you to set various command
line parms (if any).
- This parms may also be set in the "TREEWALK=" DOS
ENVIRON string. Using the command line parm makes
this change temporary (for the current TW session
only). Using the environment parm makes this
behavior change affect all future sessions of TW
until you change the ENVIRON string, or until you use
/NOASK on the TW command line.
/NOASK - this parm exists mainly to allow you to override
the /ASK parm when it is set in the DOS "TREEWALK="
ENVIRON string. In general, if you /ASK and /NOASK
together on the TW command line, the /ASK parm will
be ignored.
- The /NOASK parm cannot be set in the DOS
"TREEWALK=" ENVIRON string, since this is the normal
default behavior for TW.EXE.
In general, TW will evaluate and implement your desired
options in the following sequence,
[1] The "TREEWALK=" DOS ENVIRON string
[2] The TREEWALK.INI configuration file (see below)
[3] The parms on the TW command line
Page: 8 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
Using TREEWALK.INI to Change Defaults:
-------------------------------------
Starting with V2.20 (and higher), you can alter the display
colors used in TW.EXE (note that if you use the "/M" parameter in
either the ENVIRON or on the command line, TW.EXE will ignore any
color values it may find in TREEWALK.INI.
Starting with V3.00, you may also change the default file
viewer / editor (the default is "LIST"). You can either specify a
different default program file name to use in TREEWALK.INI, or use
"ASK" to force TW to always ask you, on a case-by-case basis, which
file viewer / editor (and what command line parms) to use. See
further instructions in the TREEWALK.INI specimen file, included.
Note that the "ASK" parm may be set in the TREEWALK.INI file
or in the DOS ENVIRON or on the TW command line. The command line
will override BOTH. However, only by using TREEWALK.INI can you
specify a *particular* program file name to use as the normal default
within TW other than "LIST". If you do specify a different program
name in TREEWALK.INI, TW will also allow you to enter any command
line parms you may desire.
If you DO use "ASK", you will be able to enter any program
file name, any .BATch file name, or even internal DOS commands. If
you enter COMMAND (or 4DOS) you can get a DOS shell. Be aware that
any file handling commands you may use while in a DOS shell will NOT
automatically update TW's FILE MANAGER screen display when you
return. See also the "/" command in FILE MANAGER.
If you do NOT wish to alter the default configuration, I
suggest that you either delete or rename the TREEWALK.INI file which
came with this package. This will help speed up (slightly) the time
it takes for TW to get "up and running".
If you wish to alter the default color configuration, you
should use any text file editor (note that the editor you use MUST
end each line with a "hard" carriage return/line feed pair (hex
0D0A). I also suggest that you keep an unaltered backup copy
of TREEWALK.INI available for any later use you may have.
Simply type over the numeric value at the start of each line
in the TREEWALK.INI file which you wish to change. TW.EXE will use
this new color value the next time you load it.
NOTE: - TREEWALK.INI cannot be renamed - if you do rename this file,
TW.EXE will ignore it. Also, TREEWALK.INI *must* be located
somewhere on your current DOS PATH. It need NOT be located
in the same directory as TW.EXE.
Page: 9 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
The Initial Screen:
------------------
After you have started TW.EXE, a screen similar to the
following will appear:
.....................................................................
Drive F: Has 10 Directories SaveTree Files Bytes %
F:\[ROOT] 9 4,274,605 52.4%
├────FAM_ANL ................................ 38 327,162 4.0%
│ ├────BETTY 115 911,363 11.2%
│ ├────CINDY 6 37,675 0.5%
│ ├────GREG 10 72,899 0.9%
│ ├────JADA 20 149,579 1.8%
│ ├────LARRYR 3 15,241 0.2%
│ └────MIKE 28 200,881 2.5%
└────GRAPHICS................................ 34 1,318,974 16.2%
└────GIFS 17 851,795 10.4%
F1 │ F2 │ F3 │ F4 │ F5 │ F6 │ F7 │ F8 │ F9 │ F10
Help│MkDir│Drive│RmDir│Paths│Search│Delete│Print│Stats│ Load
.....................................................................
This screen starts by telling you, in the upper left hand
corner, which drive is being used (in this example, drive F:) and how
many directories are currently on the drive (including the ROOT).
The "SaveTree" is a reminder that the TREE structure data is
being written to disk - this will *ALWAYS* appear unless you specifed
the "/NS" option at start up or in the DOS "TREEWALK=" parm (you also
can toggle this feature on and off during execution of TW - see the
F1 HELP menu for details - but since it has *ALREADY* saved the two
files at this point, this has limited value unless you subsequently
change drives from within TW.EXE).
Next to "SaveTree" may (or may not) appear a similar little
reminder, "ReadTree", which refers to whether or not you specified
the "/R" parm on the command line parm or in the DOS ENVIRON
"TREEWALK=" parm (the one which forces a physical re-read of the DOS
TREE structure). If you see the "ReadTree", the physical disk read
operation *IS* being forced; if you don't, TW.EXE is relying on the
"TW!.DAT" and the "TW!!.DAT" files. You can toggle this function on
and off - see the F1 HELP menu for details.
Page: 10 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
Initial Screen (continued):
---------------------------
The column labelled "FILES" tells you how many files are
currently in each directory. This count includes hidden files, but
does not include subdirectories (if any).
The column labelled "BYTES" tells you the total bytes
contained in all the files in each directory. Note that this figure
is merely the total of the file sizes as reported in the DOS
directory listing - it does not have anything to do with the number
of bytes contained in all the clusters occupied by files. Note that,
if a cluster size for your disk is 2,048 bytes (this does vary by
hard disk and by DOS version) and you have a file which is 10 bytes
long, the column labeled "BYTES" reports the file size as 10, not
2,048.
The rightmost column is labelled "%" (hey, I ran out of
screen columns, OK?!) and is derived as follows:
Total number of bytes in files (not in file-occupied
clusters) in the individual directory)
----------------------------------------------------
Total number of bytes in all files (again not in file
clusters) on the entire disk
Note that, by definition, the sum of all these percentages
will always be = 100%.
This is intended as a measure of which directories have the
most files and/or bytes in them so that you can manage the entire
disk instead of just individual directories.
NOTE: The columns labelled "FILES", "BYTES" and "%" are
always updated after every file operation you perform
within TW, so that they are always current no matter
what.
This is useful so that you can immediately examine
the effects of any file COPY or MOVE or DELETE
operations in "real-time". The downside is that it
takes a few seconds to do, but I feel it's worth it!
The hilite bar will be located on either the current default
directory or on the root, depending on whther you used the "[d:]"
parm at startup time, and whatever the current default directory for
the given drive happens to be.
Page: 11 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
Initial Screen (continued):
---------------------------
The bottom two screen rows contain the available functions,
most of which are available from the FKeys (those which are not
available from FKeys can be found in the F1 - HELP screen). More on
all of these below. When you are at this TREE MANAGER level of TW,
you can exit the program in either of two ways:
Press ESC to return to your original start up drive and path.
OR
Press ENTER to exit to the currently hilited drive and path.
NOTE: If you have used the F4 (RmDir) function to delete the
PATH from which you started TreeWalk, you will not be able to
exit by pressing ESC (since the start-up PATH no longer exists!).
In this case, move the hilite bar to another PATH and press
ENTER.
NOTE: When you attempt to exit, TW will check drives "A"
and "B" to see if they are "ready", but does not check any other
drive spec. TW assumes that any other drive will *always* be
"ready".
NOTE: TW V3.00 is the first to recognize and handle HIDDEN
sub-directories as well as regular sub-directories.
Page: 12 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
Using the TREE Manager:
----------------------
After you get to the Initial Screen, you can begin to use the
TREE MANAGER section of TW.EXE. (Note that if you started TW using
the optional "." parm, you should skip to the section below named
"Using The FILE MANAGER").
The hilite bar can be moved to any of the various directories
by using the UP arrow, the DOWN arrow, the HOME key and the END key.
If the directory listing is too long to fit on the screen, you can
also try using the PGUP and PGDN keys.
As an alternative, you can use the built-in "quicksearch"
feature - press the key corresponding to the first letter in the
directory name you want. The hilite bar will immediately move to the
first directory which starts with the letter you pressed. Press it
again to go to the next directory name starting with that letter, and
so on.
NOTE: This "quicksearch" only searches forward, not backward, and
does not wrap around when it hits the end. I happen to
like it that way, but if I get enough complaints, I'll
change it!
If you press the ENTER key, you will immediately CHDIR to the
hilited directory entry, and exit to DOS in that drive and directory.
If you press the ESC key, you will exit to DOS in your original
startup drive and directory.
Other functions are available from the FKey "menu" on the
bottom two screen rows, as follows:
F1 - HELP - on line "help" giving brief descriptions of what all
the available functions are in the TREE MANAGER section of
TW.EXE.
F2 - MKDIR - similar to the DOS MKDIR, except that the directory
will be created automatically as a subdirectory of whatever
directory the hilite bar is currently on. You never need to
type a "\" character using this approach! Note you must be
in the ROOT to create a subdirectory from the ROOT.
Page: 13 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
Using the TREE Manager(continued):
---------------------------------
- Using this function will automatically turn ON the
"ReadTree" function, and will automatically update the
TW!.DAT and TW!!.DAT files.
F3 - DRIVE - allows you to change the drive which TW is using.
A sub-menu of available drives will be presented, and you can
choose from ONLY those drive letters which appear by pressing
the corresponding letter key.
F4 *** {DIFFERENT BEHAVIOR FROM V1.2A} ***
- RMDIR - this removes the currently hilited directory, BUT
IS DIFFERENT from the DOS RMDIR command. If the directory is
empty, it is simply deleted (see NOTE below). TW corrects
the info in "TW!.DAT" and "TW!!.DAT" automatically for the
next time out, and sets the "ReadTree" function to "on".
- If the directory is NOT empty, you will be asked if it is
OK to delete all the files first.
CAUTION: - TW can (and will) delete any file, whether Hidden,
Read-Only, or whatever (but not a sub directory entry)! File
attributes can be altered from the FILE MANAGER section of
TW, using the F9 key function menu (described below).
- If you say OK to delete all files, TW deletes all the files
WITHOUT asking for any further confirmation, and then removes
the directory itself, then corrects the info in "TW!.DAT" and
"TW!!.DAT" automatically for the next time out.
- NOTE: TW cannot remove a directory entry if that directory
currently has any open sub-directory entries, even if those
sub directory entries contain no files.
- NOTE: TW can (and will) remove the specified directory
even if it happens to be the current default directory (after
deleting all the files), and this behavior differs from
V1.2A. (Not even TW can remove the ROOT directory under any
circumstances!)
Page: 14 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
Using the TREE Manager(continued):
---------------------------------
- If you start TW from a given sub-directory, and then use F4
to delete it, you will NOT be able to exit TW by pressing the
ESC key (since the drive and path you started from no longer
exist). You MUST move the hilight bar to a new path and
press ENTER to exit TW in this circumstance.
F5 - PATHS - this is a toggle to control how the directory
entries are displayed. The default is to display a graphic
tree structure; press this key to get the actual DOS PATH
NAMES for each directory. This non-graphical display of DOS
PATH NAMES is useful when you want to print the directory
data but your printer won't handle graphics characters (see
F5, below).
- This is useful in training inexperienced users how to
visualize a DOS TREE from a list of actual DOS PATH names (or
vice versa).
F6 - SEARCH - this invokes a GLOBAL SEARCH for a filespec which
you will be asked to provide. This allows you to search an
entire disk for any particular file (DOS wildcards are
accepted and recognized appropriately) and it steps thru each
directory (starting at the ROOT) for any and all matching
files.
- Each time a match is found, you will be given the option of
either LOADing the matching files in that directory (see F10,
below) or of merely continuing the search.
- Note that this search will wrap-around to the ROOT after
exhausting all other directories, in case you want to "go
back" to a previously-found match. If not, just press ESC.
F7 - DELETE - similar to F6, above, except that TW will attempt
to GLOBALLY DELETE all files which match your given file
spec.
- When the first match is found, you are given the option to
say [Y]es, [N]o, [A]ll matches, or [Q]uit.
Page: 15 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
Using the TREE Manager(continued):
---------------------------------
NOTE: Using the [A] option will causes TW to delete all
matching files in all directories without asking any further
confirmation - USE THIS WITH CARE! The best use I have found
for this is in removing the host of .BAK and .TMP files
created as intermediate files by several different software
packages.
- CAUTION: TW can delete any file, regardless of whether it
is Hidden, Read-Only, etc. Note that file attributes can be
changed from the FILE MANAGER section of TW, using the F9 key
function menu (described below).
F8 - PRINT - This will send a copy of the TREE data currently
displayed on the screen to the printer.
NOTE: This routine assumes that your printer can print
graphics characters. If it can't, (and TW will warn you
about this at run-time!) the results will be "less than
satisfactory".
HINT: If your printer cannot handle graphics characters, try
using the F5 key (see above) to change the screen display to
the actual DOS PATH names and then use this F8 print
function. The DOS NAMES display contains no graphics
characters when it is printed.
F9 - STATS - (same as pressing the TAB key) This provides you
with a quick insight into the current status of your hard
drive, by providing a popup window containing the following
info:
Page: 16 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
Using the TREE Manager(continued):
---------------------------------
╓─────────────────────────────────────────────────╖
║ [*] Disk Statistics for Drive C: [*] ║
╟─────────────────────────────────────────────────╢
║ # Bytes per sector: 512 ║
║ # Sectors per cluster: 4 ║
║ Total # clusters on disk: 16,335 ║
║ # Clusters unused on disk: 4,424 ║
║ % Clusters available on disk: 27.1% ║
║ # Bytes in avail. clusters: 9,060,352 ║
║ # Files on disk: 937 ║
║ # Bytes used by files: 23,262,096 ║
║ Total # bytes on disk: 33,454,080 ║
║ # Bytes unused on disk: 10,191,984 ║
║ % Bytes available on disk: 30.5% ║
║ Current System Date: 10-01-1992 ║
║ Current System Time: 12:12:28 ║
║ ║
║ <*> Press Any Key To Continue <*> ║
╙─────────────────────────────────────────────────╜
- Note that the above info compares the number of
bytes found in files (as measured by the DOS file
size) against the number of bytes contained in
clusters. Be aware that DOS allocates your disk
space in cluster-sized chunks (a file 10 bytes long
occupies 1 entire cluster, or 2,048 bytes (512 per
sector times 4 sectors per cluster) in the above
example).
- The only thing you have available for new files is
the item labelled above as "# Bytes in avail.
clusters" (in the above example, 9,060,352).
- By comparing the "# Bytes unused on disk" to the "#
Bytes in avail. clusters", you can get a
quick-and-dirty handle on the "slack" space on your
disk (i.e., the space allocated to files by DOS which
is not filled by the files themselves).
F10 - LOAD - This causes TW.EXE to invoke the FILE MANAGER, and
load all the files in the currently hilited directory. See
"FILE MANAGER" section, below.
Page: 17 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
Using the FILE MANAGER:
----------------------
Unlike V1.2A, the current V3.00 is sensitive to the DOS
"COMSPEC=" environment variable. This variable is normally set by
DOS whenever you start up your system, and exists to inform DOS how
to execute a DOS SHELL. If you are curious, just type the command
SET <enter> at the DOS prompt to see how many other things are being
stored as ENVIRON variables.
Regular PC-DOS and MS-DOS normally set the COMSPEC= to be
"COMSPEC=[d:\path\]COMMAND.COM", indicating that COMMAND.COM is to be
invoked in response to any request for a DOS shell. On the other
hand, 4DOS and NDOS would set COMSPEC=[d:\path\]4DOS.COM or
COMSPEC=[d:\path\]NDOS.COM, respectively.
TW V3.00 reads this COMSPEC variable when it starts up to
determine what features are to be available to the user. If it finds
4DOS or NDOS in the COMSPEC variable, it will automatically activate
the special TW features which deal with file commenting.
NOTE: - TW relies on the functionality inherent in the
4DOS / NDOS programs to provide its own extra features, and
changing your COMSPEC variable manually won't alter this.
You cannot obtain true file commenting capability by simply
changing your COMSPEC= variable!
Keeping this in mind, the following section outlines TW
functions for FILE MANAGEMENT, and will clearly label the functions
which are available ONLY under 4DOS / NDOS.
Page: 18 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
The following is an example of the screen display shown when you invoke
the FILE MANAGER section of TW.EXE:
*** Running Regular DOS ***
...............................................................................
[*] C:\QB\*.* contains 21 file(s) [*]
UFiles Marked - COUNT: 0 Files Marked - BYTES: 0
. 0 11-06-1990 12:17 / / / /DIR
. 0 11-06-1990 12:17 / / / /DIR
INCLUDE . 0 11-06-1990 12:18 / / / /DIR
LIB . 0 11-06-1990 12:17 / / / /DIR
PROGS . 0 11-06-1990 12:18 / / / /DIR
BC .EXE 77175 02-27-1991 14:40 ARC/ / / /
BCOM45 .LIB 220919 09-28-1988 01:43 / / / /
BQLB45 .LIB 24789 09-28-1988 01:07 / / / /
OPT .CFG 281 06-27-1991 14:50 / / / /
OPT .EXE 84764 11-15-1989 11:30 ARC/ / / /
PP .CFG 136 11-17-1989 08:24 / / / /
PP .EXE 75048 11-10-1989 16:02 ARC/ / / /
PREQLB .EXE 80817 06-12-1991 10:44 ARC/ / / /
F1 │ F2 │ F3 │ F4 │ F5 │ F6 │ F7 │ F8 │ F9 │ F10
Help │ Copy │ Move │ View │ Mark │ Mask │ Delete│ Print │Change │ Sort
===============================================================================
*** Running 4DOS / NDOS, and the hidden file "DESCRIPT.ION" exists ***
...............................................................................
[*] C:\QB\*.* contains 21 file(s) [*]
UFiles Marked - COUNT: 0 Files Marked - BYTES: 0
. 0 11-06-1990 12:17
. 0 11-06-1990 12:17
INCLUDE . 0 11-06-1990 12:18
LIB . 0 11-06-1990 12:17
PROGS . 0 11-06-1990 12:18
BC .EXE 77175 02-27-1991 14:40 Command line QB compiler
BCOM45 .LIB 220919 09-28-1988 01:43 QB Library for stand-alone .EXE files
BQLB45 .LIB 24789 09-28-1988 01:07 Support module for QuickLibs
DESCRIPT.ION 737 01-21-1992 15:28
OPT .CFG 281 06-27-1991 14:50 Config file for "OPT.EXE"
OPT .EXE 84764 11-15-1989 11:30 QB Source file optimizer
PP .CFG 136 11-17-1989 08:24 Config file for "PP.EXE"
PP .EXE 75048 11-10-1989 16:02 Pre-Processor for QB source files
PREQLB .EXE 80817 06-12-1991 10:44 See info in "PREQLB.DOC"
F1 │ F2 │ F3 │ F4 │ F5 │ F6 │ F7 │ F8 │ F9 │ F10
Help │ Copy │ Move │ View │ Mark │ Mask │ Delete│ Print │Change │ Sort
...............................................................................
Page: 19 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
Using the FILE MANAGER(continued):
----------------------------------
In both cases above, the following is shown on the screen,
starting at the top:
- The name of the current drive and path which TW is
displaying, along with a count of all files TW found.
- On the far left of the next line, the letter "U" indicates
that the file listing is Unsorted (you can change this using
the F10 function - see below).
- Next is the number of files you currently have MARKed (see
the F5 function, below) and the sum of bytes in all the files
you have MARKed.
- Following this is a complete listing of all directory
entries contained in the drive and path (mainly files, but
also includes sub-directory names).
Note that the file listing displays information on ALL files,
including Hidden, Read-Only, etc files presented in a format which is
similar to the DOS DIR format, but the right side also tells you the
either the current status of each file's attribute byte (under
regular DOS) or the contents of the file's 4DOS / NDOS comment. Note
that, under 4DOS / NDOS, you can toggle the display to match the one
presented under regular DOS if you wish (press the "." key).
Under the regular DOS file listing format, the right-hand
side of the listing is a literal representation of the file's current
attribute byte (you can change the attribute byte using the F9
function, below. Also, the F5 file MARKing function can key in on
this value).
If a file had all attributes set, the righthand side of the
line would read "ARC\R-O\HID\SYS". You can interpret this as
follows:
- If ARC appears, the ARCHIVE attribute is SET
- If R-O appears, the file is READ ONLY
- If HID appears, the file is HIDDEN
- If SYS appears, the file is a SYSTEM file (like IBMBIO.COM)
- If DIR appears on the far right, then the entry is not a
file at all, but is rather a DIRectory entry.
The hilite bar can be moved in the same way as in the TREE
MANAGER section, above.
Page: 20 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
Using the FILE MANAGER(continued):
----------------------------------
The FKey menu appears again on the bottom two screen rows,
offering the following functions:
F1 - HELP - on line help (brief descriptions of what functions
are available in this FILE MANAGER section of TW.EXE).
- Note that contents of the actual HELP screen will vary
depending on whether you are running regular DOS or 4DOS /
NDOS.
- Note that the help screen also contains information on
other TW functions which are not attached to FKeys.
F2 - COPY - allows you to copy either a single file or a group
of files (see F5 file MARKing function, below) to another
directory and / or drive. You will asked to enter the
desired destination, which will be checked to insure that it
is a valid destination, AND that the destination is not the
same as the source.
- Unlike DOS, you may type the name of a *new* sub-directory
as the destination if you want TW to try to create it
(subject to the same limitations as the DOS MKDIR command).
Also unlike DOS, TW does NOT support FILE RENAME during a
COPY operation.
- As each file is copied, the destination is checked to be
sure that enough space exists to safely copy the file. In
the case of a hard disk, the copy will abort if there is not
enough room. If the destination is a floppy diskette (i.e.,
drive A: or B:), you will be given the option of replacing
the diskette if it becomes "full" rather than simply aborting
the whole copy procedure.
HINT: - You may wish to sort the file listing (see F10 below)
to control the order in which files are copied so as
to minimize the number of floppy diskettes needed.
F3 - MOVE - same as the F2 COPY operation, above, except that
after the file(s) are successfully copied to the destination,
the source files are deleted (you will NOT be asked to
confirm this deletion before it occurs). You cannot RENAME a
file during a MOVE.
Page: 21 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
Using the FILE MANAGER(continued):
----------------------------------
F4 - VIEW/EDIT - same as using the ENTER key - the behavior of
this option will vary depending on whether you have elected
to invoke the "/ASK" option either from the DOS "TREEWALK="
ENVIRON string, the TREEWALK.INI file, or the TW command
line.
- If you have NOT used "/ASK", the default action will invoke
an external file viewing program named "LIST" and pass it the
name of the currently hilited file as an argument. You will
not be asked for any other command line parms for "LIST".
- Note that Vern Buerg's LIST.COM is highly recommended and
widely available from any BBS in the country (just about) but
is not included with TW.
- If you HAVE invoked "/ASK", pressing F4 or ENTER will
present you with a dialog window asking you which program to
use. Pressing ENTER alone assumes you want to use LIST, but
you can type the name of any program file, .BATch file, or
internal (4)DOS command (including, by the way, COMMAND or
4DOS or NDOS, which will invoke a DOS shell from within TW's
FILE MANAGER). See also above page 9 for further info.
- If the program file you want to use requires its own
command line parms BEFORE the file name (eg, PKZIP) you
should type them in after the program name, then press ENTER.
- The hilited file name will be added to the command line you
have typed, and displayed for you. You will now have the
opportunity to add any additional command line parms which
are supposed to come AFTER the hilited file name (press ENTER
for none, or ESC to quit here).
- Finally, the completed command line you have entered will
be displayed for you, and you will be asked whether TW should
pause after completion before returning. This is useful if
the program itself outputs to the display screen - note that,
if the final output is less than a full screen, TW will
immediately erase it and return UNLESS you answer Y to this
"pause" option.
Page: 22 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
Using the FILE MANAGER(continued):
----------------------------------
- If you are not sure whether to use Y or N, try Y first.
Note that, even at this point, ESC will quit the whole
process.
NOTE: - If the program or function you choose affects the
file listing in TW's currently displayed FILE MANAGER
screen, TW will NOT automatically detect this and
update its display. If this is a problem, ESCape
from the FILE MANAGER, and re-enter (F10) the
directory from the TREE MANAGER.
F5 - MARK - be aware that all file operations (i.e., COPY, MOVE,
DELETE, etc) within TW can act on either a single file (the
currently hilited file name) or on a group of files which you
define. Note that the second row of the FILE MANAGER screen
always displays the number of files which have been MARKed,
as well as the total number of bytes in all MARKed files.
- Within TW, there are several ways to MARK a group of files.
The simplest is to move the hilite bar to each filename you
want and then press the "+" key. If you make a mistake,
hilite the file name and press the "+" key again.
- But TW offers you several other ways to MARK a group of
files. When you press the F5 function key, the FKey menu on
the bottom two screen rows changes to offer you the following
functionalities (and be aware that MARKing operations are
cumulative - to MARK all files with the EXT = .FMT and/or
.WK1, simply use F6 twice - once for each extension. To
ERASE all MARKs, use F5 then F9):
F1 - on line help describing what the other keys do when you
are MARKing files.
F2 - ATTRIB - allows you to MARK all files which share a
common file attribute (see above page 18). You will be
asked to specify which attribute you want to use as a
MARK criterion.
F3 - DATE - allows you to MARK all files which have a file
date within a given range of dates that you will be
asked to specify (between START and STOP date).
F4 - SIZE - allows you to MARK all files which are within a
range of files sizes that you will have to specify
(lower size limit -> upper size limit).
Page: 23 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
Using the FILE MANAGER(continued):
----------------------------------
F5 - NAME - allows you to MARK all files which CONTAIN a
string of characters which you will specify.
- This is NOT the same as DOS, since if you specify the
string "THE", for example, TW will MARK files named:
THEO.FIL OTHER.FIL SSSTHES.FIL
- Note that wildcards are NOT allowed here.
- Note that the EXTENSION is ignored here, so that in this
example, the file "XXXX.THE" would NOT be MARKed (but
see below F6).
F6 - EXT - allows you to mark all files which match the three
letter EXTENSION which you will be asked to specify.
F7 - CURRENT - toggles the MARK state of the currently
hilited filename (same as "+").
F8 - +ALL - MARKs all files
F9 - -ALL - UNMARKs all files
F10 - REVERSE - toggles the MARK state of all files - all
files which are currently MARKed will become UNMARKed,
and vice versa.
F6 - MASK - Allows you to control which filenames are displayed.
You will be asked to specify a legal DOS filespec (wildcards
are allowed) and then only the matching files will be
displayed in the FILE MANAGER screen window. If any files
have been MARKed (via the F5 function, above), you will be
asked if OK to remove all MARKs before changing the MASK.
- This is helpful is have a *lot* of files in your directory
and you want to see just a subgroup of matching files on
the screen at one time.
- If you just press ENTER here, the file mask will revert to
its default of *.* (show everything!).
NOTE: - The file note editing features of TW (for users of
4DOS / NDOS) are not active unless the file "mask" is
"*.*", which is the default. However, file notes
will still be displayed on the screen for your
reference (unless you press the "." key).
Page: 24 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
Using the FILE MANAGER(continued):
---------------------------------
F7 - DELETE - Allows you to delete a single file or group of
MARKed files (same as DEL key)
NOTE: - TW.EXE can and will delete any file regardless of
whether it is Hidden, Read-Only, etc. However, this DEL (F7)
function cannot delete a sub-directory entry.
NOTE: - The 4DOS / NDOS "DESCRIPT.ION" file will NOT be
updated until you EXIT the FILE MANAGER.
CAUTION: If you press this key, the currently hilited file
will be deleted WITHOUT ASKING FOR CONFIRMATION
UNLESS you have MARKed any file(s) (even one), in
which case you WILL be asked to confirm the delete.
F8 - PRINT - sends the currently displayed list of filenames to
the printer.
HINT: - Use the F6 MASK function to control which filenames
go to the printer.
NOTE: - The file listing will be numbered on the left hand
side of the printout IF you are *not* printing the
4DOS / NDOS file comments. An asterisk ("*")
will be printed after the number to alert you if a
file note exists but was not printed.
F9 - CHANGE - Invokes the Fkey menu of file change functions
(all of which except for F10 operate on either the single,
currently hilited filename, or on the currently MARKed group
of iles), defined as follows:
F1 - on line help of what the other keys do within the File
Change function
F2 - SET the Archive attribute for the file(s)
F3 - SET the Read-Only attribute for the file(s)
F4 - SET the Hidden attribute for the file(s)
F5 - SET the System attribute for the file(s)
F6 - CLEAR the Archive attribute for the file(s)
Page: 25 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
Using the FILE MANAGER(continued):
---------------------------------
F7 - CLEAR the Read-Only attribute for the file(s)
F8 - CLEAR the Hidden attribute for the file(s)
F9 - CLEAR the System attribute for the file(s)
F10 - change the name of the currently hilited filename
F10 - SORT - allows you to SORT the displayed listing of
filenames in the following ways (which you will be asked to
specify):
ASCENDING order by File NAME
ASCENDING order by File EXTENSION
DESCENDING order by File Date
DESCENDING order File Size
UNSORTED (the original DOS directory order)
"/" - The SLASH key suspends operation of TW.EXE and invokes a
DOS shell. The success of this depends on the "COMSPEC="
string in the DOS ENVIRON, so that if you are running DOS,
you get a DOS shell; if you are running 4DOS, you get a 4DOS
shell; ditto for NDOS.
NOTE: - If you use any DOS commands which affect the file
listing for the current directory, TW will not
automatically update the FILE MANAGER display screen
when you type EXIT to return to TW.
If this causes you a problem, press ESC to return to
the TREE MANAGER, and then press F10 to re-enter the
desired sub directory; this will cause TW to update
the FILE MANAGER display.
NOTE: - When you SHELL to DOS, be aware that TW is still in
memory, and is using approx 240K of your system's
RAM. Therefore, if you try to run a LARGE program,
you may not have enough free RAM to succeed.
Page: 26 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
Using the FILE MANAGER(continued):
---------------------------------
Those of you using 4DOS / NDOS will also find the following
keys active (and they also appear on your F1 help screen):
TAB - Allows you to create / edit / delete the current 4DOS /
NDOS file comment. Key usage instructions are on the screen
in Edit dialog box. This function is active ONLY when you
are viewing ALL files in the directory (i.e., "*.*" on F6).
" - The QUOTES key alows you to copy the file comment from the
currently hilighted filename to any other file(s) you wish.
Simply press the " key (no need to use the SHIFT) and a popup
box will appear to tell you that you are copying a file note.
At the same time, a blinking letter "C" will appear in the
upper right hand corner of the screen to remind you that a
file comment has been copied to the TW internal clipboard.
- Bring the hilight bar down to the file name to which you
wish to copy the note, and press the " key again. If the
file to which you are copying the file comment already has an
existing comment of its own, you will be asked to confirm the
overwrite. If no comment currently exists, the file comment
will be immediately copied to the currently hilited file.
- Be aware that the TW file comment clipboard retains its
contents so that you can copy the file note to more than one
file if you wish. To clear out the clipboard, try to copy
the clipboard note to any file which already has an existing
file comment, and press the " key. You will be asked to
confirm the replacement of the existing file comment with the
new one - press [Q] or [ESC] to erase the clipboard, or just
[N] to cancel the file comment copy but retain the TW file
comment clipboard contents.
"." - The PERIOD key allows you to toggle the format of the file
listing from the 4DOS / NDOS comment format to the "regular
DOS" format (which displays the file attribute byte values).
NOTE: Pressing the period key will have no effect unless
there is a file containing file notes (named "DESCRIPT.ION").
NOTE: It is perfectly OK to enter and edit file notes (if you
are using 4DOS or NDOS) even when you are not currently
viewing them - however, I think you'll find it preferable to
display the file notes before doing any editing! If you are
in doubt, press the period key at any point. It can't hurt!
Page: 27 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
Program Limitations:
-------------------
In version 3.00, the following limitations are known (and if
you find any others, please let me know - if there's enough interest,
I'll be happy to try to revise and / or customize TW.EXE. Remember,
feedback is everything!):
<> SORTing the list of files in the FILE MANAGER is not as fast
as I'd like, *especially* when you sort by date. If any of
you know any real good sort algorhythms for ASCII
"MM/DD/YYYY", please let me know!
<> Not enough different options on the FILE SORT menu.
<> If your hard disk contains more than 300 directories /
subdirectories per drive you're out of luck!
<> If any single directory contains more than 700 files, you're
out of luck! (But why would you DO this to yourself?)
<> All printing routines make no assumption as to type of
printer and are formatted at 60 lines per page and 80 or 82
characters per line. This provides a more-or-less plain
vanilla print style, but it's more likely to work on all
printers, from EPSON to HP to ...?
Note that you can set printer setup strings using the
"TREEWALK.INI" file to take advantage of "fancier" print
styles if you wish.
<> 4DOS / NDOS file notes are assumed to be <= 40 characters,
even though the most recent version of 4DOS allows you to
make the file notes longer than this. If you already have
a file note longer than 40 characters, TW will truncate the
note to 40 characters. (40 has always been enough for me, at
least!)
<> TW cannot recognize a "STACKER" type drive (sorry!). In
addition, although I have not specifically tested, I think TW
will not work with ANY non-DOS-standard drive (eg, SuperStor)
and with the Norton Utilities "secure" directories; TW DOES
work with most RAM-drives.
<> If your DOS "PATH=" ENVIRON string contains more than 50
different PATHs, TW.EXE will be unable to find (and therefore
unable to use) the TREEWALK.INI file.
Page: 28 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
Tech Notes:
----------
TW.EXE requires a CGA / EGA / VGA adapter card, since it uses
screen write routines which address RAM memory locations directly.
If the video RAM in your system does not start at B800:0000 (which is
the case for a lot of monochrome video boards), you cannot use TW.
TW.EXE was written primarily using Microsoft BASIC PDS V7.1
but includes 28 separate (original) sub-routines written entirely in
assembler which provide functionalities lacking in BASIC. I used
Microsoft MASM V5.1 / V6.0 to assemble all these routines.
I'll happily answer any specific questions you may have about
the program code / logic / etc - please use CompuServe electronic
mail, or send me a regular letter or postcard. Please do NOT call me
on the telephone. I have been known to distribute partial source
code so if you are interested, let me know!
The TW.EXE file distributed herein has been compressed using
the "LZEXE.EXE" program. This compression conserves space on your
hard disk, and reduces your download time, but in certain instances
can present problems (or so I hear). Do not hesitate to uncompress
TW.EXE (use UNLZEXE.EXE) if you wish.
Page: 29 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
Revision History:
----------------
Version 2.00
------------
was first released to the public on 01/27/92, and was hastily
withdrawn following user feedback that it *really* didn't work on
their machine. This lead to my discovering that MS-DOS INT 25h does
not result in standard responses on certain machines (notably COMPAQ
386, ZEOS 386, etc - thanks Dianne and Mark!).
After fixing this "bug", V2.00 was re-released on 02/06/92
with revised documentation. I found out that the DOS INT 25h "bug"
still persisted under somewhat more rare conditions.
Version 2.01
------------
was first released to the public on 02/11/92, and hopefully
that DOS INT 25h problem is now squashed once and for all.
V2.01 first included the ability to set program parameters
from either the command line or from a DOS ENVIRON parm.
Version 2.20
------------
was first released 07/27/92, and included some bug fixes:
- The problem with editing 4DOS/NDOS file notes being
EXACTLY 40 characters is gone.
- The problem of TW "forgetting" your file sort order when
you deleted multiple files is gone.
V2.20 was the first to allow the user to customize display
colors by using the TREEWALK.INI file.
V2.20 increased the maximum number of sub-directories per
system from 100 to 200, and provided error-checking to prevent any
"hangs" (which occurred in previous versions).
Page: 30 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
Version 3.00
------------
was first released to the public on 10/13/92
- This release was a substantial re-write of most of the TW
source program, using new routines for handling files which allowed
me to increase the number of sub-directories per drive (I was amazed
at how many folks out there have *huge* hard drives with more than
200 sub-directories!) The current limit is 300 subdirectories per
drive.
- V3.00 recognizes and handles HIDDEN sub-directories.
- V3.00 has some real improvements in the area of screen
scroll performance (especially when viewing large directories of
files using the UP and DOWN arrow keys).
- V3.00 also contains numerous enhancements to existing
routines. In previous versions, when dealing with many of the
file-handling functions, TW had a "habit" of returning you to the
very top of the file list after performing the desired function.
This tendency has been minimized (no, not completely eliminated!) in
V3.00.
- V3.00 also allows you to specify a different default
program to use during the file view/edit function (ENTER or F4)
within the FILE MANAGER area, along with customized command line
parms, if any are desired. This feature also allows a DOS shell from
within TW's FILE MANAGER (and there is also an actual "DOS SHELL"
feature available as well).
Next version:
------------
What, exactly, do YOU want to see TW do?
Page: 31 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
APPENDIX A
Quick Reference to TreeWalk V3.00 Parameters (ALL are OPTIONAL)
---------------------------------------------------------------
In general, TW will evaluate and implement your desired
options in the following sequence:
[1] The "TREEWALK=" DOS ENVIRON string
[2] The TREEWALK.INI configuration file (see below)
[3] The parms on the TW command line
Parameter Explanation Available From
Literal of Function Comm Line / ENVIRON
D: or . Drive to use at start up Y / N
(colon is optional)
/25,/43,/50 Start TW in 25,43,or 50 row mode Y / Y
(highest value rules)
/R Force TW to physically read Y / Y
disk TREE structure
/NS Force TW to NOT write the Y / Y
TW!.DAT and TW!!.DAT files to disk
/? or /HELP Display summary of parms on screen Y / N
/M Start TW in MONOCHROME mode Y / Y (1)
/ASK Force TW to "ask" you how to
VIEW / EDIT files in FILE MANAGER Y / Y (2)
/NOASK Force TW to ignore "ASK" in the
TREEWALK.INI file Y / Y (3)
(1) Use of /M will override any color statements in TREEWALK.INI.
Use of /M in ENVIRON cannot be overridden on Command Line.
(2) ASK can also be placed in the TREEWALK.INI file if desired.
(3) In the TREEWALK.INI file, NOASK is the same as LIST.
Page: 32 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
APPENDIX B
Map of Colors used in TREEWALK.INI File
---------------------------------------
The purpose of this Appendix is to give you a clearer idea of
what screen display items will be affected when you make changes in
the color values in the TREEWALK.INI file.
Line 1 = ClrScrnColor
---------------------
- This color value is used in all screen clearing (analogous
to CLS) instructions.
- You will see it as a "border" around the TREE MANAGER, and
on its top line. Similarly, you will see it as a "border"
around the FILE MANAGER, and on its top two lines.
- You also see it on the opening screen when TreeWalk reads
the disk directory structure.
- Changes here should be considered in conjunction with Lines
12 and 13, below.
- The DEFAULT value = 23 (Grey on Blue).
Line 2 = RegTreeColor
---------------------
- This color value is used for the display of the DOS PATH
names or graphical TREE structure within the TREE MANAGER.
- The DEFAULT value = 48 (Black on Cyan).
Line 3 = BoxColor1
------------------
- This color value is primarily in screen dialog boxes as the
color of informational text displayed to you.
- It is also used as the color used to clear screen dialog
boxes (like CLS for a "box" area).
- It is also used to erase the "<*> Press Any Key ..." text.
- Finally, it is used as the hilite color for the DOS PATH
names / TREE structure displayed under the hilite bar in the
TREE MANAGER.
- The DEFAULT value is 112 (Black on White/Grey).
Page: 33 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
Line 4 = BoxColor2
------------------
- This color value is used as the secondary color of text
displayed in screen dialog boxes.
- It is also used as the hilite color for the DOS PATH
statistics (# Files and # Bytes) for the DOS PATH curerntly
under the hilite bar in the TREE MANAGER.
- The DEFAULT value = 113 (Blue on White/Grey).
Line 5 = BoxBorderColor
-----------------------
- This color value, as its name implies, is used primarily
for the "lines" used in drawing the various screen dialog
boxes.
- The DEFAULT value = 120 (Light Black on White/Grey).
Line 6 = BlinkColor
-------------------
- This color value is used for screen messages, generally
found in dialog boxes, which "blink" to call your attention
to them. These include messages such as "<*> Press Any
Key...", "Please Wait", "One Moment, please...", etc
- The DEFAULT value = 241 (Blinking Blue on White/Grey).
Line 7 = FKeyMenuColor
----------------------
- As you might expect, this color value controls the color in
which the normal FKEY menu is displayed on the bottom two
screen rows.
- Note that Secondary FKEY menus (those displayed, for
example, after you press F5 or F9 in the FILE MANAGER) are
controlled by the "HiLiteFileColor" variable, below, line 10.
- The DEFAULT value = 113 (Blue on White/Grey)
Line 8 = RegFileColor
---------------------
- This value is used in the display of file info in the FILE
MANAGER section. It is used for bothe the file names, sizes,
etc, as well as either the attribute string or the file note
data.
- This is also the color used in screen clearing (CLS)
functions in the FILE MANAGER.
- The DEFAULT value = 48 (Cyan on Black).
Page: 34 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
Line 9 = CurrRegFileColor
-------------------------
- This color is used to display file data in the FILE MANAGER
section for the file which is currently under the hilite bar.
- The DEFAULT value = 112 (Black on White/Grey).
Line 10 = HiLiteFileColor
-------------------------
- This color value is used to to display file info in the
FILE MANAGER section for those files which have been MARKed
for COPY, MOVE, DELETE, etc.
- This color is also used for the secondary FKey menus (such
as those displayed in the FILE MANAGER when you press F5 or
F9). See also Line 7, above.
- The DEFAULT value = 14 (Bright Yellow on Black).
Line 11 = CurrHiLiteFileColor
-----------------------------
- This color value controls the color of MARKed files in the
FILE MANAGER display on which the hilite bar is currently
resting.
- The DEFAULT value = 126 (Bright Yellow on White/Grey).
Line 12 = TitleTextColor
Line 13 = AltTitleTextColor
---------------------------
- These two color values control the information which is
displayed on the top row of the TREE MANAGER, and the top two
rows of the FILE MANAGER.
- Changes to these colors should be considered in conjunction
with Line 1, above.
- The DEFAULT for TitleTextColor = 30 (Bright Yellow on Blue)
- The DEFAULT for AltTitleTextColor = 31 (Bright White on
Blue)
Line 14 = TreeStatsColor
------------------------
- This color value is used for the display of the "# Files"
and "# Bytes" in each of the DOS PATHs displayed in the TREE
MANAGER. The DEFAULT value = 3 (Cyan on Black).
Page: 35 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
Line 15 = WarningColor
----------------------
- This color is used for various warning messages which
generally appear in dialog boxes. Examples would be messages
warning you of impending file deletions, directory deletions,
etc.
- The DEFAULT = 116 (Red on White/Grey).
Page: 36 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
APPENDIX C
Using Printer Control Codes in TREEWALK.INI
-------------------------------------------
Lines 18 through 22 in the TREEWALK.INI file are used to
allow you to customize the hard-copy printouts provided by TW.EXE
from its F8 function keys. (Note that Line 17 is RESERVED.)
Please understand that this section is entirely optional -
you can leave lines 18 - 22 blank if you wish. This section is
strictly for those who would like to enhance their TW printouts.
You should be familiar with the concept of printer control
code strings before you continue. These are, basically, a string
of characters which you can send to your printer to alter the way
it prints (eg, setting italics, or emphasized print, etc). The
Owner's Manual for your printer should contain a reference table of
printer control codes for your particular model of printer. This
Appendix will include examples for EPSON (and compatible) printers,
as well as for Hewlett Packard LJ Series II (and compatible)
printers.
In this section of the TREEWALK.INI file, all printer control
codes are entered as strings of 3-digit ASCII characters seperated by
blank spaces. This is similar to the format used by Lotus 1-2-3
(except that Lotus 1-2-3 uses the "\" character to seperate the
3-digit codes while TW uses a blank space). The ESC character
(used to start many of the control code strings) is represented by
the string 027 (see examples below).
Line 18 should contain the control codes for the type of
print you want to see in the "Title" lines of the print out. (HINT:
You may also want to include the control codes to get your printer to
use graphics characters, if your printer supports this function but
is not set this way as a default).
As an example, lets assume you want to see the titles in BOLD
ITALIC style of typeface. The appropriate line 18 in TREEWALK.INI
would be:
EPSON (and compatible): 027 069 027 052
HP LJ II (compatibles): 027 040 115 049 083 027 040 115 051 066
Page: 37 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
Line 19 in TREEWALK.INI should contain printer control codes
to cancel anything and everything you set in line 18. Line 19 should
"turn OFF" any special printer characteristics you "turned ON" in
line 18. Following the example we set above, if we set BOLD ITALIC
in line 18, our line 19 should be:
EPSON (and compatible): 027 070 027 053
HP LJ II (compatibles): 027 040 115 048 083 027 040 115 048 066
---------------------------------------------------------------------
The remaining lines affect the way the printout of data (as
opposed to page title info) is printed. As a general rule, I
strongly urge you avoid using printer control codes which set
proportional font spacing (since the printout won't look very good!).
Stick with fixed-space fonts. Note that Lines 20 and 21 are NOT used
the TW TREE MANAGER printout; they are used in the TW FILE MANAGER
only.
Line 20 (see also note below for line 21) in TREEWALK.INI
should contain the printer codes for the printing of the FILE data
from the FILE MANAGER printouts. If you wanted, for example, to see
the file name, size, date, and time printed as being underlined, use
the following:
EPSON (and compatible): 027 045 001
HP LJ II (compatibles): 027 038 100 068
Line 21 in TREEWALK.INI should contain the control codes to
use for printing the file's attribute string (or, for 4DOS/NDOS
users, the file note info).
NOTE: Any printer changes you make in Line 20 will continue
into the printing of the current file's note or
attribute unless you specifically turn them off here.
NOTE: Any printer changes you make in Line 21 will continue
into the printing of the next line's file name data unless
you turn it off here.
For example, in the above line 20, you set the underline
feature to be "turned on". The underlining will continue into the
printing of the file note or attribute unless you use Line 21 to
"turn off" the underlining again.
Page: 38 of 39 --------------------- Last Revised: 10/13/92
TreeWalk (TW.EXE) - V3.00 - User Documentation
If you wanted to print the file attribute or note data in
12cpi (for example) but without underlines you should set Line 21 as
follows:
EPSON (and compatible): 027 045 000 027 077
HP LJ II (compatibles): 027 038 100 064 027 038 107 052 083
Note that both the above examples start by turning OFF the
underline feature, and then turning ON the 12 CPI feature.
Note that the 12 CPI feature will STAY ON for the printing of
the next line's file name, size, date, and time UNLESS you use line
20 to "turn off" the 12 cpi feature. You could do this by adding the
following to each of the above example Line 20's:
EPSON (and compatible): 027 080
HP LJ II (compatibles): 027 038 107 048 083
---------------------------------------------------------------------
The above discussion probably is more complicated than it
needs to be. You should try different combinations on your own
printer to determine which printing style enhancements work best for
you. Note that, as I said before, if you wish, you can leave these
five lines blank and TW will still print just fine (just not fancy!).
Note, too, that the actual control codes you use are limitted
only by your imagination, and by your printer's capabilities!
---------------------------------------------------------------------
Line 22 should contain the control code needed to reset
(sometimes called "initialize") your printer. This causes the
printer to do a "soft" reset - equivalent to switching the printer
off, and then back on.
This code is sent after each TW printout in order to cancel
any and all of the codes you may have set in Lines 18, 19, 20, and 21
- in effect, this will "clean out" your printer (i.e., make it as it
was before you used TW to print anything). These codes are as
follows:
EPSON (and compatible): 027 064
HP LJ II (compatibles): 027 069
========================= [ END OF TW.DOC ] =========================
Page: 39 of 39 --------------------- Last Revised: 10/13/92